<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Enttec DMXUSB Output Plugin</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">

<H1>DMX USB input/output plugin</H1>

<H2>Introduction</H2>
<P>
The DMX USB plugin supports a variety of FTDI-based USB-to-DMX devices:
<UL>
 <LI>DMXKing USB DMX512-A</LI>
 <LI><A HREF="https://dmxking.com/usbdmx/ultradmxmicro">DMXKing ultraDMX micro</A></LI>
 <LI><A HREF="https://dmxking.com/discontinued/ultradmx-pro">DMXKing ultraDMX Pro</A></LI>
 <LI><A HREF="https://www.enttec.com/products/controls/usb/open-dmx-usb/">Enttec DMXUSB Open</A></LI>
 <LI><A HREF="https://www.enttec.com/products/controls/usb/2-universe-usb-computer-interface-dmx/">Enttec DMXUSB Pro</A></LI>
 <LI><A HREF="https://www.enttec.com/products/controls/usb/dmx-usb-pro-mk2-2-universe-usb-computer-interface-dmx/">Enttec DMX USB PRO Mk2</A></LI>
 <LI><A HREF="http://www.dmx4all.de/produkte_usb_dmx_interfaces.html">DMX4ALL USB-DMX STAGE-PROFI MK2</A></LI>
 <LI><A HREF="http://www.dmx4all.de/produkte_usb_dmx_interfaces.html">DMX4ALL NanoDMX</A></LI>
 <LI><A HREF="http://www.guselectronics.com/usb-dmx-interface-512">Gus Electronics USB-VL344</A></LI>
 <LI><A HREF="http://www.dmx512-online.net/en-article58.html">Vince DMX512 USB</A></LI>
 <LI><A HREF="http://www.electrotas.com/usbdmx.html">ElectroTAS USB-DMX</A></LI>
 <LI><A HREF="https://www.steinigke.de/en/mpn51860118-eurolite-usb-dmx512-interface-update-adaptor.html">Eurolite USB-DMX512</A></LI>
 <LI><A HREF="https://www.steinigke.de/en/mpn51860120-eurolite-usb-dmx512-pro-interface.html">Eurolite USB DMX512 Pro</A></LI>
 <LI><A HREF="https://www.steinigke.de/en/mpn51860122-eurolite-usb-dmx512-pro-cable-interface.html">Eurolite USB-DMX512 Pro Cable</A></LI>
 <LI><A HREF="https://www.steinigke.de/en/mpn51860121-eurolite-usb-dmx512-pro-interface-mk2.html">Eurolite USB DMX512 Pro MK2</A></LI>
 <LI><A HREF="http://www.ftdichip.com/Products/Modules/USBRSxxx.htm">FTDI USBCOM 485+</A></LI>
</UL>

<H2>Configuration</H2>
<P>
DMX USB devices should be automatically detected from QLC+ and displayed in the input/output panels list.<br>
If for some reason the auto-detection fails, you can "force" the type of your DMX USB adapter manually.<br>
Click on the name of your device and open the configuration dialog by clicking on
the <IMG SRC="qrc:/configure.png" width=32> icon on the bottom-right side of the panel.<br>
You will see a list of DMX USB devices currently connected to your computer. Each one has a drop down menu
where you can force the device type.<br>
Here's the meaning of each one:
<UL>
 <LI><B>Open TX</B>: Enttec USB DMX Open (and clones) in output mode</LI>
 <LI><B>Open RX</B>: Generic FTDI devices receive mode</LI>
 <LI><B>Pro RX/TX</B>: Enttec USB DMX Pro or most of the DMXKing devices</LI>
 <LI><B>Pro Mk2</B>: Enttec USB DMX Pro Mk2 - 2 DMX outputs, 1 DMX input, 1 MIDI IN and 1 MIDI OUT ports are available</LI>
 <LI><B>Ultra Pro</B>: DMXKing ultraDMX Pro with 2 outputs and 1 input</LI>
 <LI><B>DMX4ALL</B>: DMX4ALL USB-DMX STAGE-PROFI MK2</LI>
 <LI><B>Vince Tx</B>: Vince DMX512 USB in output mode</LI>
</UL>
<B>Note for OSX users:</B> If your adapter is detected but doesn't produce any output, most likely you'll find the solution
in the <A HREF="questionsandanswers.html#osx-mavericks">Questions and Answers</A> page (Question #3).<br>
<B>Note 1</B>: Eurolite USB-DMX512 Pro devices must be forced to the "Pro RX/TX" mode to operate correctly.<br>
<B>Note 2</B>: On Windows, Enttec open DMX clones might flicker at 44Hz. You can try and decrease the output frequency until the issue is resolved.
</P>

<H2>Requirements</H2>

<H3>Linux</H3>
<P>
On all Linux distributions, you need to install libftdi. If you install QLC+ with the Ubuntu
Software Center or some other automatic installer tool, this library will be installed
automatically for you.<br>
In some cases, if the device doesn't output anything, it might be useful to add your user
to the "dialout" group with the following command:<br>
<PRE>sudo adduser your_user_name dialout</PRE>
</P>

<H3>macOS</H3>
<P>
On Apple macOS, you don't need any drivers at all since QLC+ uses the macOS native USB
interface. Installing the D2XX drivers should cause no harm, but <B>DO NOT INSTALL VCP (Virtual COM Port) drivers</B> as they will definitely interfere
with QLC+. If you have previously installed the VCP drivers, consult the
<A HREF="http://www.ftdichip.com/Support/Documents/InstallGuides.htm">FTDI installation guides</A> on how to uninstall them.<br>
<br>
<B>OSX Mavericks (or later) issues</B>: please check <a href="questionsandanswers.html#osx-mavericks">Questions &amp; answers #3</A>
</P>

<H3>Windows</H3>
<P>
On Microsoft Windows, the plugin needs the <A HREF="http://www.ftdichip.com/Drivers/D2XX.htm">latest D2XX drivers from FTDI</A>.
Normally, when a FTDI device is plugged in for the first time, Windows will automatically download the D2XX drivers for you, so no
action is needed at all.<br>
If that doesn't happen, please consult the <A HREF="http://www.ftdichip.com/Support/Documents/InstallGuides.htm">FTDI installation guides</A>
to know how to install the drivers.<br>
<B>DO NOT INSTALL VCP (Virtual COM Port) drivers</B> as they will probably interfere with the D2XX interface.
</P>

<H2>ENTTEC DMX USB Pro supported modes</H2>
<P>
Following a grid showing the IO modes supported by QLC+ for devices like DMX USB Pro and Pro Mk2.<br>
If a mode is not listed here, it means it is not supported by QLC+ or the device itself because of hardware limitations,
so please do not report them as issues in the QLC+ forum.<br>
<br>
<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD></TD>
  <TD>1</TD><TD>2</TD><TD>3</TD><TD>4</TD><TD>5</TD><TD>6</TD><TD>7</TD><TD>8</TD><TD>9</TD><TD>10</TD><TD>11</TD><TD>12</TD><TD>13</TD><TD>14</TD>
 </TR>
 <TR>
  <TD>DMX1 IN</TD>
  <TD>o</TD><TD> </TD><TD> </TD><TD>o</TD> <TD></TD> <TD></TD><TD>o</TD><TD> </TD><TD> </TD><TD>o </TD><TD>  </TD><TD>  </TD><TD>o </TD><TD>  </TD>
 </TR>
 <TR>
  <TD>DMX1 OUT</TD>
  <TD> </TD><TD>o</TD><TD> </TD><TD> </TD><TD>o</TD><TD> </TD><TD> </TD><TD>o</TD><TD> </TD><TD>  </TD><TD>o </TD><TD>  </TD><TD>  </TD><TD>o </TD>
 </TR>
 <TR>
  <TD>DMX2 OUT (1)</TD>
  <TD> </TD><TD> </TD><TD>o</TD><TD>o</TD><TD>o</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD>  </TD><TD>  </TD><TD>  </TD><TD>  </TD><TD>  </TD>
 </TR>
 <TR>
  <TD>MIDI IN (2)</TD>
  <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD>o</TD><TD>o</TD><TD>o</TD><TD> </TD><TD>  </TD><TD>  </TD><TD>o </TD><TD>o </TD><TD>o </TD>
 </TR>
 <TR>
  <TD>MIDI OUT (2)</TD>
  <TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD>o</TD><TD>o </TD><TD>o </TD><TD>o </TD><TD>o </TD><TD>o  </TD>
 </TR>
</TABLE>
<br>
(1) DMX2 OUT is available only on DMX USB Mk2 Pro<br>
(2) MIDI IN and MIDI OUT are available only on DMX USB Mk2 Pro with a 5-way breakout cable. MIDI OUT signals are sent
from 1 to 512 as described in the <a href="midiplugin.html#channelsmap">MIDI plugin channels map</A><br>
</P>

<H2>Tuning</H2>
<P>
<B>Note: Manual tuning should never be performed except for some very particular cases. Use it at your own risk!</B><BR>
It is possible to change the DMX frame size for Enttec Open (and like) devices with a
hidden settings key on each platform. The key tells QLC+ how many channels should be transmitted in each DMX frame, so for a DMX universe (by default 512).<BR>
Please refer to the <A HREF="parameterstuning.html#EnttecOpen">Manual parameters tuning</A> DMX USB Enttec Open section
</P>

</BODY>
</HTML>
